home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / lanman_2.zip / TOOLS / 3COMUTIL / README.TXT < prev   
Text File  |  1992-03-10  |  3KB  |  91 lines
  1. 3COMUTIL
  2. --------
  3.  
  4. 3NAME2LM is a simple utility designed to help administrators migrate
  5. 3+Name user accounts to LAN Manager.
  6.  
  7. 3NAME2LM is an OS/2 program that reads information from a 3+Name account
  8. database and writes its output to STDOUT in .CMD file format.  This .CMD
  9. file contains NET USER and NET GROUP commands, so it can be run on a LM
  10. domain controller to add the accounts to the LM UAS database.
  11.  
  12. Given the numerous factors involved in migrating user accounts from 3+Name
  13. to LM, we realized that writing an account migration utility that is both
  14. general-purpose and all-encompassing is not feasible.  For example, because
  15. 3+Name user names can be longer than LM user names, there is no simple,
  16. straightforward way to migrate such names.  As such, we have employed a
  17. two-step approach to the problem.  The first step, which is automated, is
  18. to read as much information as possible from 3+Name and convert it to a
  19. format that is useful in an LM context (an OS/2 batch script containing
  20. NET commands).  The second step, which is administrator-driven, is to
  21. examine the output of the first step, modify it as necessary, and run
  22. the resulting script.
  23.  
  24. Note: Since there are some differences in the way groups are handled in
  25. 3+Open and LM 2.x, users in multiple groups will end up on the LM system
  26. only in the group corresponding to the users' privilege level (which must be 
  27. ADMINS, USERS or GUESTS).
  28.  
  29. Please submit both bug reports and feature requests to Microsoft.
  30.  
  31.  
  32. Usage
  33. =====
  34. 3NAME2LM [switches]
  35.  
  36. Valid switches:
  37.     /? or /HELP - Displays a usage message.
  38.     /PASSWORD:string - Uses <string> as the password for all migrated
  39.         accounts.
  40.     /QUIET - Don't display status messages.
  41.  
  42. Accounts are read from the 3+Name domain to which the user is currently
  43. logged on (with LOGON2).
  44.  
  45. 3NAME2LM writes its output to STDOUT.  As such, it is likely that you
  46. will want to redirect its output to a command file, e.g.
  47.  
  48.     3NAME2LM > 3migrate.cmd
  49.  
  50.  
  51. User Name Conversion
  52. ====================
  53. The following strategy is used by 3NAME2LM to convert 3+Name user
  54. names to LM user names:
  55.  
  56.     1.    Check to see if the 3+Name user has property 260 (LAN Man
  57.     user name) defined.  This property is used in conjunction
  58.     with the version of LOGON (and LOGON2) that is part of the
  59.     Microsoft Upgrade Toolkit for 3Com Networks, Release 2.
  60.  
  61.     If so, use the value of this property as the LM user name.
  62.     Otherwise, go to step 2.
  63.  
  64.     2.    Check to see if a 3+Name alias that is LM-compliant (i.e., at
  65.     most, 15 characters in length and no spaces) has been defined
  66.     for this 3+Name user.
  67.  
  68.     If so, use this alias as the LM user name.
  69.     Otherwise, go to step 3.
  70.  
  71.     3.    Truncate the name to 15 characters, and replace each space
  72.     with an underscore.
  73.  
  74.  
  75. Group Name Conversion
  76. =====================
  77. Group name conversion is done using steps 2 and 3 of user name conversion.
  78.  
  79.  
  80. Limitations
  81. ===========
  82. 1.    3+Name passwords are not migrated.  If a /PASSWORD switch is
  83.     specified, the specified string is used as the password for
  84.     all LM accounts.  If it is not specified, the first eight
  85.     characters of LM user name are used for each account.
  86.  
  87. 2.    Home directories are not migrated.
  88.  
  89. 3.    Inter-domain and inter-organization group memberships are not
  90.     migrated.
  91.